home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / sunclock / README < prev    next >
Text File  |  1995-05-25  |  2KB  |  39 lines
  1. Sun Clock - X11 Version 1.0
  2.  
  3. X11 version by John Mackin, <john@cs.su.oz.AU>, based on a Suntools program
  4. by John Walker, <kelvin@acad.uu.NET>.
  5.  
  6. This program is a clock that shows which portion of the Earth's surface is
  7. illuminated by the Sun.  It is designed to be usually iconic, but can be
  8. opened for a larger display with the time updated every second and both the
  9. local timezone and UTC displayed.  The Suntools version had a menu that
  10. allowed you to speed up time, show different dates, etc., but I have
  11. never implemented any of that in the X version; there is some support
  12. for it in the code, however.
  13.  
  14. The program should have been written using Xt rather than raw Xlib, and I
  15. tried that at first.  I couldn't get the icon window to work, though, so I
  16. abandoned that version.  Hence, the program does _not_ accept most Xt-style
  17. command line options; valid options are given in the manual page.
  18.  
  19. The program has been tested on a number of different clients (MIPS, Sun,
  20. VAX) and servers (MIPS colour console, Sun MIT mono, NCD-16/19), under X11R3
  21. and R4.  If you find bugs, please report them to me, john@cs.su.oz.AU.
  22.  
  23. To build the program, decide whether you want to use imake or not.  If you
  24. don't, link Makefile.dist to Makefile, and edit it, otherwise edit the
  25. Imakefile and use xmkmf.  The program uses two fonts, one for the icon
  26. display and one for the large window display.  The names of these fonts
  27. are compiled in.  The font names comes from -DBIGFONT and -DSMALLFONT
  28. in the Makefile.  If you are not using imake, you will need to supply
  29. a -DSYSV option if you are System V.  You should supply -DNEW_CTIME if
  30. you are using the table-driven ctime and a "struct tm" contains
  31. a tm_zone field.  If neither of the ways of getting the local timezone
  32. name works on your system, please let me know.
  33.  
  34. The original Suntools program, in case you want it, was posted as Volume 1,
  35. Issue 79 of comp.sources.sun.
  36.  
  37. This program is public domain and may be freely copied as long as the
  38. notices at the top of sunclock.c remain intact.
  39.